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The sia a aipelte | File Systern is supported at two levels. Ai the first 
re converted to NCP Library calls. The second level, the 
art ‘converts AmigaDos calls into the appropriate NCP Library 
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ve Test ee! OF SUE joport for Novell record locking abilities comes at the 
NCP Library iev¥e. Al this level all NCP related functions are Suppo orted. In 


me! Linrary 3 source code thie can be found in the file NCPSYNCH.C. 


The second more mportam ou pport of record locking is handled by 
wie Webwork hander, This ievel ofS upport of record iocking allows the native 
AmigaDos to handie the functions of locking and unlocking records. 


The concent of record locking is the ability for an application to specily 
a certain number of vies of information somewhere ina file to be 
eyclucively ayattable for the use of the application. one is necessary 
especialy ina multhuser environment where the possibility of several 
ications updating ihe same record is high. Witha record lock in place 
eral programs can update the same file but different records, and not be 
inle to modify the same information. 
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capa bitty ‘the translation of te Amiga programs to Novell applications 
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Section II 
Technical Specifications: 
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Tizcvasion of the application of these methods Is possible only with the 
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The first mieinad locking aniv one range of one file uses an immediate 
version of the Log physical fil ile !ock function call. This is best if only one 
record of ane file needs ta be locked Ifmore files and records needto he 


incked. then the second method should be used for deadiock prevention. 
The second method involves logging each file, offset, andiengthtoa 


lock table, ainlained entirery by the file server, and calling the Lock file set 
Function. thet reason for using this method is so that f the appli cation needs 
5e¥e kesecch ae Sea the lock will not be given ian 
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The application musi cali the library routines documented in 
Section Ill. Fora better explanation please refer to the MCF Library 
Fersion Ff. Faocumentation 
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Section Il 
NCP Library Functions 


The following uprary functions are documented in this section: 


‘ Opena file see 
eGo Reada file 
aos, Write toa file 

4 Nel “5 ose} _ Close a file i 

a AFPCreateFile() . Create a file i 

6. AFPCreateDir() Creaie a directory 
7. AFPDeieteFile(} | __Delete a file or directory 

ae Logh Record(} | __Logarecord for locking 

9 LockSet() ___Lockallrecords logged 

1) ° —ReleaseRecord)) | _Release a record froma lock 
it UnieckSetG) | Releaseailrecordsfromlock set} 


The documertation for each of the function calls conform to the format 
layed out by Commodore. This includes the name of the function, an 
evarrple call to the function, an explaination of what the function does, and 
4 breakdown of inputs and outputs. 
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This fiinction attempts to open the file described in the name 
field of the function call. The DiriD field contains the directory of 
he Mle Sy NULL to begin from the root directory. The filehar 
raturnad inthe fd field. 
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Result-o successful otherwise coniains the Novel error, 
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meiRead -- Read a open file 


Fesuit=NetRead{ fd, offset buf, bufsize } 


UWORD fdj3i: 


char Butt 
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OL ifsize: 
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at function attempts to read the file with the file handle pass 

Ott. The offset field contains the offset in bytes from ihe 
anne. ig of the file to begin reading. The buffield contains a 
pointerto a buffer for the incoming information. The bufsize fi 
teils the function the number of bytes to read. 


INPUT 5 
fe- pointer to storage of filenandie 
offsei - integer describing first byte to read from beginning 
buf- pointerto buffer for storage of inforrnation 
nursize - integer describing number of bytes to read 
RESULTS 


Result- 0 if successful, otherwise contains the Novell erro 
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Resuit=Netwriterfd offset buf dufsize } 
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Tite function attempts t th wrife if: thy a file tN with the fileha die 
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fd- pointer to storage of filenandle 

offset - integer describing first byte to read from beginning 
a uf - pointer to buffer fo r storage of information 

bursize - integer describing num ber of bytes to read 


Result - 0 if successful, otherwise contains the Novell error. 
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NetLioss -  Closea file 
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Pesuit- Gif successful, otherwise contains the Novell error. 
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None 
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Result= AFPCreaterFilel name Dir, NewiD } 
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This function creates a file called "name, located in directory 
ONG unless DirlD is 0 in which case the file is created in the root 
directory, The directory 1D which the file is created in is returned 
inthe NewiD field. 
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name - string containing name of file to open 
CirlO- NULL or directory id file resides in 
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Result- 0 if successful, otherwise contains the Novell error, 


None 


S$. Martin 2M Umar. -An 4/3/90 


alae File System Specifications 


i? 1989 Gee in. 


i 


- 
a 


Createfir  -- Create a directory 


Resuit= AFPCreateDir( name , DID, NewiD } 
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FUNCTION 


This function Creates a directory called "name", located in 
directory Dini Uy i unless CiriDis G in which case the file is created 
in the root d lirectory. The directory iD created is returned in ihe 
New +e: D field. 


MPT SS 
name - String containing name of directory to create — 
Dib~ NULL or drettory anew decoy sto reside 
Newitt - returns the new directory iD 
RESULTS 
Result- 0 if successful, otherwise contains ihe Novell error. 
BUGS 
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aFPiieeteriie -- Llelete a fie or directory 
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FUNCTION 


This function deletes a file or directory called name, located in 
directory| 0 a) unless DirlD is @ inwhicn case tne file is deleted 
from the root directory 
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DID - NULL or directory id file resides in 


Resuil- 0 if successful, otherwise contains itie Novell error. 
RLIGS 
None 
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LogRecord --  Entera file and record into the tock log 


2 SYINGPSIS 


Result=LogRecord/ filenandie , offset ien , type , timeout } 
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This function enters a record lock into the log table on the file 
server. ifthe "type" fields bit 0 is set, the lock request is 
immediately carried out. Bit 1 of the "type" fleld determines the 


‘type of lock to be granted {either exclusive [0] or shareable [1 ]}. 
“flehandie" is a pointer to a file handle structure. "offset" contains 
ine Oise irom ihe beginning of the file to jock and “len is. a word 


Aes air ;ouNnt of tie to walt fora lock to be grante 


fllehandle -a pointerte a filenandle structure 

offset -a lang containing the offset from the 1 st byte offile 
iefi-a ene containing the number of bytes to lack 

type - a byte containing the type of lock to hale 


timeout-4 longcentaining the number of ticks to timeout 
RESULTS 
Result-0 successful, otherwise contains the Novell error. 


LockSet, ReleaseRecord, UniockSet 
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Resutt=LockSet type , timeout } 
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This function locks all records entered into the lock log using the 

LogRecord function. The “type" field bit 1 determines which type 

of record lock fo use ‘either exclusive [0] or shareable [1 ]}. The 

“THOU TEN 1S USed TO Set a Maximum wait period for the file 
“j0ck 1G BE granted. 


INPUTS 
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‘a nlains € ther [0] Exclusive lock or [1] Shareable tock 
long 5 containing the number of ticks tit timeout 


Result-0 ifsuccessful, otherwise contains the Noyell error. 


jRecord ReleaseRecord, UniockRecord 
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Result = ReleaseRecora, tilehandie , offset fen} 
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leases “len” bytes starting at location “offset from 
efile desc ribe by the filehandie “filehandie”. This range of 
riyte e5 must have previously been locked using the LogRecord 
ae tion call. 


This function re 
file 


Hlenandle - a pointer to storage of filehandie 
offset- a tong containing the offset from byte 1 of file 
len-a long containing the number of bytes to release 


Result- 4 ifsuccessful otherwise contains the Noveil error. 


None 


LogRecord ,LockSet  UniockRecord 
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This function releases all records locked by function LockSet. 
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NONE 


~~ Resuit- if successful otherwise contains the Novell error. 
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S Martin & Mo Umen ~14- 4/3/88 


Amiga-Novell File System Specifications 
iC} 1989 Oxo, inc. 


Section IV 
Proposed additions to dos library 


in order for armigalios to suppart record locking, the fwe functions must 
oe added! it ne aos dora ary At thus tirne Commodore is being consulted 
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, documentation. These are proposed additions to the 
icket Protocol, 


The only probien y vith defining new AmigaDos packets is that the 
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packet ID rnust be unique and not Used by any other application or systern 
program. 
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FreeRecord untocks the specified range of bytes ina file. ifthe 
range of bytes is different than what was in the original record 
loc "2 request, an error occurs. ifa range of bytes is stilliocked 
when this call isrnade, only the bytes outside of the overlap, will 


ne unlocked, 
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Me - BCPL pointer toa file handle 
Hon - integer 
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Struct FileHandle *file 
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LONG position, length, mode, timeout: 
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This function flocks a byt eae S vithin the speécifie 
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ack mode 


2M Exclusive Lock 
' - immediate Exclusive Lock 
2, & ohareabie Lock 


3 - immediate $ 


The earg ument time out ‘Specifies how many ticks 


file - BCPL pointer to a file handie 
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The timeout arguy ment is used t Specify how iong 
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Lock Record Packei 
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Mode: Bron 8 Exclusive Lock. 
f = Exciusive Lock (immediate - no timeout), 
2 - Shareable Lock. 
3 Shareable Lock {immediate}. 

timeout: Hicks (50 per second) 


Free Record Packet 


Type « LONG . Action FreeRecord (2009) 
Arai. BPTR File Handle Argi 


New AmigaDos error return codes needed: 


ERROR_RECORD_NOT_LOCKED 240 
ERROR LOCK COLLISION 241 
ERROR LOCK TIMEOUT 22 

ERROR UNLOCK ERROR 243 
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